home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / c501afix.zip / C501A.EXE / README.1ST < prev   
Text File  |  1992-09-07  |  7KB  |  183 lines
  1. CA-Clipper 5.01a UPDATE
  2. =======================
  3.  
  4. Welcome to CA-Clipper 5.01a!
  5.  
  6. Here are the steps to take to upgrade CA-Clipper 5.01a.
  7.  
  8. 1.  Make a backup copy of your CA-Clipper 5.01 sub directories and files:
  9.        \BIN
  10.        \INCLUDE
  11.        \PLL
  12.        \SOURCE
  13.        and all sub directories
  14.  
  15. 2.  Executing the file C501A.EXE provides the following files:
  16.  
  17.        README.1ST  - The file you are currently reading
  18.  
  19.        501A.EXE    - Deltafile with CA-Clipper 5.01a changes
  20.  
  21.        C501A.NG    - Norton Guide update summary
  22.  
  23.  
  24.     When the 501A.EXE is executed it creates a backup copy of each target
  25.     file before updating it.  These backup files are readily identified
  26.     by the "$" in the file extension (CLIPPER.EXE becomes CLIPPER.EX$).
  27.  
  28.     It is important to understand that this Deltafile patch will only work
  29.     on unmodified Clipper 5.01 files.  If you have modified any of the 
  30.     CA-Clipper 5.01 files, copy your changes to a safe place and restore
  31.     the original files before running the Deltafile.  If you continue to
  32.     have problems you may need to re-install CA-Clipper from your original
  33.     diskettes.
  34.  
  35.     Another potential source of trouble is a CA-Clipper system that was
  36.     installed without the sample programs (such as RL or DBU).  If you
  37.     installed CA-Clipper 5.01 and did not choose the full installation,
  38.     you will need to re-install the full system before the Deltafile will
  39.     recognize your system as correct.
  40.  
  41. 3.  Perform the following steps to update your CA-Clipper 5.01 to 5.01a.
  42.  
  43.     a.  Copy 501A.EXE to your \CLIPPER5 sub directory and execute it.  The
  44.         Deltafile verifies the appropriate files, and updates them to the
  45.         new versions.
  46.  
  47.     b.  If you have changed the directory where CA-Clipper 5.01 resides, be
  48.         sure to change the environment variables (LIB, INCLUDE, PLL, etc.)
  49.         to the new directories.
  50.  
  51.     c.  Copy the C501A.NG to your \NG directory.
  52.  
  53.     d.  Re-create your .PLL and .PLT files by re-linking the BASE50.RMK 
  54.         file.  This completes the installation of 5.01a.
  55.  
  56.  
  57.  
  58. NORTON GUIDE CHANGE SUMMARY
  59. ===========================
  60.  
  61. The file C501A.NG contains the release notes for the CA-Clipper 5.01a 
  62. update.  Be sure to read the release notes to familiarize yourself with the
  63. changes in this release.
  64.  
  65. The guide contains a change summary consisting of Runtime errors and the
  66. Release note #3. 
  67.  
  68. Change Summary - Runtime Errors.  Here you will find an explanation of new
  69. runtime errors added to the system.
  70.  
  71. Change Summary - Release Note #3.  This release note describes new or
  72. changed items in CA-Clipper 5.01a.
  73.  
  74.  
  75.  
  76. BUG FIXES
  77. =========
  78.  
  79. In addition to the new and changed items in this release, many items have
  80. been fixed to perform as documented.  These bug fixes include instances of
  81. the internal error 5333.
  82.  
  83. 1. Internal errors should not occur under normal conditions.  These errors
  84.    indicate that the system has failed an internal integrity check for some
  85.    unidentifiable reason. This can be caused either by a conflict with 
  86.    another piece of software (whether it is a TSR, device driver, third-
  87.    party library or utility) or because of a bug internal to CA-Clipper.
  88.  
  89.    Internal errors always have the same format:
  90.    <operation> (<line number>)  Internal error xxxx
  91.  
  92.    Note that there is no message text for an internal error.
  93.  
  94.    If you encounter an internal error:
  95.  
  96.    a.  Determine, if possible, whether the source of the error is a conflict
  97.        with other software products. Remove any unnecessary TSRs and device 
  98.        drivers, link with .RTLink for CA-Clipper and remove any third-party
  99.        libraries that you can.
  100.  
  101.    b.  Regardless of the source of the problem contact Computer Associates
  102.        Technical Support to report the error. If it is a conflict with 
  103.        another product, this will give Computer Associates a chance to work
  104.        with that vendor to remove the incompatibility.  If it is not a 
  105.        conflict, any information you can provide Computer Associates is
  106.        helpful in tracking down and correcting the bug. Also, it is 
  107.        possible that there is a work around for the particular internal
  108.        error you are receiving.
  109.  
  110.  
  111. 2.  Internal error 5333
  112.  
  113.     This error is caused by a misuse of the virtual memory system by either
  114.     an internal or external (third party) subsystem.  
  115.  
  116.     This release contains corrections to the internal subsystems that were
  117.     generating 5333 errors.  Because of this, 5333 errors in CA-Clipper
  118.     5.01a are more likely to be generated by external (3rd party) subsystems
  119.     than by internal CA-Clipper subsystems.
  120.  
  121.     If you should happen to get an internal error 5333, follow the steps
  122.     outlined above.
  123.  
  124.  
  125.  
  126. TROUBLE SHOOTING
  127. ================
  128.  
  129. PROBLEM:
  130.     501A.EXE doesn't update the system.
  131.  
  132. SOLUTION:
  133.     Make sure that all the files in the system are unmodified, and that the
  134.     system is complete.  The best way to guarantee this is to back-up your
  135.     current CA-Clipper system and reinstall CA-Clipper 5.01 from the 
  136.     original diskettes.
  137.  
  138.     If you continue to have problems contact Computer Associates Technical
  139.     Support.
  140.  
  141. PROBLEM:
  142.     The new version produces linker errors, or the application it generated
  143.     hangs on execution.
  144.  
  145. SOLUTION:
  146.     If you are using a .PLL when linking, rebuild the .PLL using the new
  147.     BASE50.RMK.  If you have set an RTLINKCMD environment variable, be sure
  148.     to remove it while linking the new PLL.  Also be sure that all the
  149.     necessary environment variables (LIB, INCLUDE, PLL, ...) refer to the
  150.     correct Clipper 5.01a subdirectories.
  151.  
  152.  
  153. PROBLEM:
  154.     Linking in different database or terminal drivers causes linker errors.
  155.  
  156. SOLUTION:
  157.     Follow the link line examples below.
  158.  
  159.     5.01a & NDX
  160.     RTLink Fi <yourobj>, DBFNDX.LIB  Lib <etc.>
  161.  
  162.     5.01a & NTXC
  163.     RTLink Fi <yourobj>, DBFNTX.LIB  Lib <etc.>
  164.  
  165.     5.01a & NovTerm
  166.     RTlink Fi <yourobj>, GT  Lib NOVTERM, <etc.>
  167.  
  168.     5.01a & NovTerm & NTXC
  169.     RTlink Fi <yourobj>, GT, DBFNTX.LIB  Lib NOVTERM, <etc.>
  170.  
  171.     5.01a & NovTerm & NDX
  172.     RTlink Fi <yourobj>, GT, DBFNDX.LIB  Lib NOVTERM, <etc.>
  173.  
  174.     5.01a & NovTerm & NDX & NTXC
  175.     RTlink Fi <yourobj>, GT, DBFNDX.LIB, DBFNTX  Lib NOVTERM, <etc.>
  176.  
  177.     ----NOTE----
  178.     ANSI, PCBIOS and NOVTERM must use the GT.OBJ that was shipped with the
  179.     driver. Since all of these replacement terminal systems use the same
  180.     GT.OBJ, they can all be linked as shown above.  Simply replace the word
  181.     NOVTERM with ANSI or PCBIOS as appropriate.
  182.  
  183.